<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>StringLower / StringUpper</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>StringLower / StringUpper</h1>

<p>Converts a string to lowercase or uppercase.</p>

<pre class="Syntax">StringLower, OutputVar, InputVar [, T]
StringUpper, OutputVar, InputVar [, T]</pre>
<h3>Parameters</h3>
<dl>

  <dt>OutputVar</dt>
  <dd><p>The name of the variable in which to store newly converted string.</p></dd>

  <dt>InputVar</dt>
  <dd><p>The name of the variable whose contents will be read from. Do not enclose the name in percent signs unless you want the <em>contents</em> of the variable to be used as the name.</p></dd>

  <dt>T</dt>
  <dd><p>If this parameter is the letter T, the string will be converted to title case. For example, &quot;GONE with the WIND&quot; would become &quot;Gone With The Wind&quot;.</p></dd>

</dl>

<h3>Remarks</h3>
<p>To detect whether a character or string is entirely uppercase or lowercase, use <a href="IfIs.htm">&quot;if var is [not] upper/lower</a>&quot;.</p>
<p>For this and all other commands, <em>OutputVar</em> is allowed to be the same variable as an <em>InputVar</em>.</p>
<p><span class="ver">[v1.1.20+]:</span> <a href="Format.htm">Format()</a> can also be used for case conversions, as shown below:</p>
<pre>MsgBox % Format("{:U}, {:L} and {:T}", "upper", "LOWER", "title")</pre>

<h3>Related</h3>
<p><a href="Format.htm">Format()</a>, <a href="IfInString.htm">IfInString</a>, <a href="StringGetPos.htm">StringGetPos</a>, <a href="StringMid.htm">StringMid</a>, <a href="StringTrimLeft.htm">StringTrimLeft</a>, <a href="StringTrimLeft.htm">StringTrimRight</a>, <a href="StringLeft.htm">StringLeft</a>, <a href="StringLeft.htm">StringRight</a>, <a href="StringLen.htm">StringLen</a>, <a href="StringReplace.htm">StringReplace</a></p>
<h3>Example</h3>
<pre class="NoIndent">StringUpper, String1, String1  <em>; i.e. output can be the same as input.</em>
StringLower, String2, String2</pre>

</body>
</html>
